home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat3 / fnmatch.0 < prev    next >
Text File  |  1996-09-02  |  3KB  |  57 lines
  1.  
  2. FNMATCH(3)                 UNIX Programmer's Manual                 FNMATCH(3)
  3.  
  4. NNAAMMEE
  5.      ffnnmmaattcchh - match filename or pathname
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ffnnmmaattcchh..hh>>
  9.  
  10.      _i_n_t
  11.      ffnnmmaattcchh(_c_o_n_s_t _c_h_a_r _*_p_a_t_t_e_r_n, _c_o_n_s_t _c_h_a_r _*_s_t_r_i_n_g, _i_n_t _f_l_a_g_s)
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.      The ffnnmmaattcchh() function matches patterns according to the rules used by
  15.      the shell.  It checks the string specified by the _s_t_r_i_n_g argument to see
  16.      if it matches the pattern specified by the _p_a_t_t_e_r_n argument.
  17.  
  18.      The _f_l_a_g_s argument modifies the interpretation of _p_a_t_t_e_r_n and _s_t_r_i_n_g. The
  19.      value of _f_l_a_g_s is the bitwise inclusive OR of any of the following con-
  20.      stants, which are defined in the include file _f_n_m_a_t_c_h_._h.
  21.  
  22.      FNM_NOESCAPE  Normally, every occurrence of a backslash (`\') followed by
  23.                    a character in _p_a_t_t_e_r_n is replaced by that character.  This
  24.                    is done to negate any special meaning for the character.
  25.                    If the FNM_NOESCAPE flag is set, a backslash character is
  26.                    treated as an ordinary character.
  27.  
  28.      FNM_PATHNAME  Slash characters in _s_t_r_i_n_g must be explicitly matched by
  29.                    slashes in _p_a_t_t_e_r_n. If this flag is not set, then slashes
  30.                    are treated as regular characters.
  31.  
  32.      FNM_PERIOD    Leading periods in strings match periods in patterns.  The
  33.                    definition of ``leading'' is related to the specification
  34.                    of FNM_PATHNAME. A period is always ``leading'' if it is
  35.                    the first character in _s_t_r_i_n_g. Additionally, if
  36.                    FNM_PATHNAME is set, a period is ``leading'' if it immedi-
  37.                    ately follows a slash.
  38.  
  39. RREETTUURRNN VVAALLUUEESS
  40.      The ffnnmmaattcchh() function returns zero if _s_t_r_i_n_g matches the pattern speci-
  41.      fied by _p_a_t_t_e_r_n, otherwise, it returns the value FNM_NOMATCH.
  42.  
  43. SSEEEE AALLSSOO
  44.      sh(1),  glob(3),  regex(3)
  45.  
  46. SSTTAANNDDAARRDDSS
  47.      The ffnnmmaattcchh() function conforms to .
  48.  
  49. HHIISSTTOORRYY
  50.      The ffnnmmaattcchh() function first appeared in 4.4BSD.
  51.  
  52. BBUUGGSS
  53.      The pattern `*' matches the empty string, even if FNM_PATHNAME is speci-
  54.      fied.
  55.  
  56. BSD Experimental                April 16, 1994                               1
  57.